QuickTime 4 Reference

Transfer Mode Flag Type

The gxTransferFlag type is used for a transfer-mode flag.



 
typedef long            gxTransferFlag;

The transfer mode flags are a set of flags in the flags field of the transfer mode structure. They affect how color limits are used and whether a single component mode is to be used for all color components. For more information about transfer modes, see "Transfer Modes" .

The following three flags are defined.

Constant	Value	Explanation
`gxRejectSourceTransfer`	0x0001	Negate the results of `sourceMinimum` and `sourceMaximum` for all components. Accept only values outside of the specified ranges.
`gxRejectDeviceTransfer`	0x0002	Negate the results of `deviceMinimum` and `deviceMaximum` for all components. Accept only values outside of the specified ranges.
`gxSingleComponentTransfer`	0x0004	Use a single transfer component for all color components. Duplicate `component[0]` in the transfer mode structure for all components in the transfer mode's color space.

Setting the gxRejectSourceTransfer or gxRejectDeviceTransfer flag causes an inversion of the acceptable color ranges for source or destination color, respectively. For example, in Figure 51 , setting the gxRejectSourceTransfer or gxRejectDeviceTransfer flag would cause the white (empty) portions of the large cubes that represent RGB space to be within range, instead of the gray (filled) portions.

The effect is similar to, although not exactly the same as, individually reversing the minimum and maximum values for the color components. If the transfer mode flag is cleared, drawing occurs only when all components are inside the allowed ranges--that is, inside the darker gray portions of the large cubes in Figure 51 . With the flag set, drawing occurs any time at least one component is outside of its allowed range--that is, with values anywhere outside of the dark gray areas in Figure 51 .

The gxSingleComponentTransfer flag is provided as a convenience. You can set the flag when you don't need the flexibility (and extra effort) of specifying different transfer modes for different color components. In this case you need set up only one gxTransferComponent structure, instead of one for each component in the transfer mode's color space.